Sie befinden sich hier: Software > DOS > HTML > LinkList > Doku    

Dokumentation von LINKLIST

Version: 1.14

2007 Apr 23


VORWORT
-------

Vorneweg: LINKLIST ist Freeware. Die Benutzung geschieht auf
eigene Gefahr. Aus rechtlichen Gruenden garantiere ich fuer nichts.
Eine Aenderung des Sourcecodes und des Programmes sind nicht erlaubt.

LINKLIST steht fuer LISTen mit LINKs

LINKLIST ist ein kleines DOS-Programm, das aus vorgefertigten
ASCII-Texten einen HTML-Code fuer eine Tabelle erzeugt.
Die Spalten der Tabelle sind sortierbar.
Dabei ist es moeglich den Eintraegen eine URL zuzuordnen.
Urspruenglich war es als reine Linkliste geplant, aber prinzipiell
koennen jede Texte so als Tabelle formatiert werden.

Warum unter DOS?
Nun, ich programmiere in QBasic gerne einen schnellen Hack,
der sich dann auch mal ausweiten kann. Ausserdem benutze ich gerne
Batches, um meine Daten zu verarbeiten. Da bieten sich DOS-Utilities
eben an.


INSTALLATION
------------

Entpacken Sie alle Dateien in ein Verzeichnis Ihrer Wahl.


BENUTZUNG
---------

Beim Start unter DOS muss dem Programm ein Dateiname uebergeben werden.
Dieser darf nicht mehr als 8 Buchstaben haben und muss auf ".lin" enden.
Eine gleichnamige Datei auf ".hea" kann einen spezifischen Text fuer
den Kopf der Tabelle enthalten. Falls diese Datei nicht existiert,
wird der Standardkopf aus "linklist.hea" benutzt. Existiert dieser nicht,
traegt das Programm einen eigenen Kopf ein. Der Kopf darf nicht leer sein,
andernfalls gibt es eine Leerzeile im Tabellenkopf.


STEUERDATEI
-----------

Die Steuerdatei Datei.lin muss folgenden Aufbau haben:

1. Zeile: Titel der Tabelle (auch mit HTML-Code).
Am Ende des Titels kann in eckigen Klammern eine Auszeichnung
stehen, wie [small] oder [b]. Achtung: LinkList setzt diese Auszeichnung
in JEDES
Tabellenelement!
Gleichfalls kann am Ende des Titels kann in geschweiften Klammern eine
Ausrichtung stehen, wie {left} oder {right}.

Danach koennen beliebig viele Leerzeilen folgen.

Die eigentlichen Daten starten mit einer Zeile, die den Text
"Definition" linksbuendig enthaelt.
Nach dieser Zeile darf KEINE Leerzeile folgen.

-- Kopf

Nun wird der Tabellenkopf definiert (ohne Leerzeilen!).
Dazu wird der Name der Spalte eingetragen. Dieser Name erscheint
als Spaltenueberschrift. Soll der Name verlinkt werden, so muss
darunter "=http" oder "= http" stehen (Auch wenn mailto:,
xxx:// folgen, muss =http stehen!).
Es sind nicht mehr als 20 Spalten moeglich!

Soll die Tabelle nach einer Spalte sortiert werden, so steht
in eckigen Klammern [sort] oder [sortname] hinter dem Wert.
[sort] sortiert nach Anfangsbuchstaben, [sortname] nach Namen
(letztes Wort im Feld). Beim Sortieren werden Ueberschriften
weggelassen! Es wird nur nach dem ersten [sort] oder [sortname]-Eintrag
sortiert!

Soll eine Spalte eine feste Breite haben, z.B. 50 Pixel, so gibt
man diese mit {50} nach dem Spaltennamen an. Es sind auch Prozentangaben
moeglich, wie {35%}. Der Wert wird direkt nach width= eingefuegt.

Die Spalten koennen auch mit "left", "right", "center", "justify"
ausgerichtet werden. Dazu traegt man nach dem Spaltennamen ein
[left], [right], [center] oder [justify] ein. Kein Eintrag heisst "left".
Bei mehreren Eintraegen je Spalte wird der erste Eintrag zur
Ausrichtung benutzt.

Spaltenbreite, -ausrichtung und -sortierung koennen in beliebiger
Reihenfolge nach dem Namen stehen (in eckigen Klammern).

Ein Kommentar wie  kann auch nach jedem Namen stehen.
Dieser Kommentar wird dann am Ende jedes Eintrages eingetragen und
anschliessend die Ausgabezeile umgebrochen. zweck ist es mit anderen
Programme (wie http://www.jostjahn.de/software/htmbytes.html) weitere
Daten spaeter einzutragen.

-- Daten

Die Definition endet mit einer Leerzeile.

Nun folgen die Tabelleneintraege.

Sie koennen dabei Zwischentitel definieren, die ueber die gesamte
Tabellenbreite gelistet werden. 
Diese Zwischentitel beginnen mit einem # in der 1. Spalte.
Mit einem [nohead] danach wird die Ueberschrift fuer diesen
Zwischentitel nicht wiederholt.

Jeder Tabelleneintrag folgt wie der Definitionseintrag.
Jeder Eintrag kann HTML-Code enthalten, muss aber in einer Zeile stehen.
In den Zeilen, wo in der Defintion =http steht, sollte eine
gueltige URL stehen (mit http://, ftp:// o.a. am Beginn).
Beginnen diese Zeilen nicht mit einem ...://, so wird auch
kein Link gesetzt (also z.B. "Kein Link").
Bei falschen Eintraegen wird der Link nicht funktionieren.

Leere Eintraege kann man z.B. mit einem Strich o.a. kennzeichnen.

HMTL-Kommentare in  werden aus dem Kontext entfernt.

Jeder Eintrag wird von einem th-Eintrag im Titel (ueber alle
Spalten) bzw. td-Eintrag fuer einen normalen Eintrag umschlossen.
Daher koennen auch komplette Tabellen und alles andere eingetragen
werden, was in so eine Tabelle passt. Nur: es muss alles in einer
Zeile stehen!

Es sind nicht mehr als 200 Tabelleneintraege moeglich!

Jede auskommentierte Zeile (mit einem ' in der 1. Spalte) wird ignoriert.


WEBSEITE
--------

Die Software liegt unter http://www.jostjahn.de/software/linklist.zip
Diese Datei liegt unter http://www.jostjahn.de/software/linklist.html

Sollten diese beiden Webseiten nicht erreichbar sein, schauen
Sie im Index von http://www.jostjahn.de nach.

Unter http://www.jostjahn.de/software/softnews.html koennen Sie sich
auch in einen Newsletter eintragen lassen, der Ihnen Updates mitteilt.


KONTAKT
-------

Verbesserungsvorschlaege und Fehlermeldungen senden Sie bitte
an webmaster@jostjahn.de


BEISPIEL
--------

Die Dateien BELILINK.LIN und BELILINK.HEA sollten vorhanden sein.
Falls nicht, hier der Beginn des Beispieles
(Beginn in der Zeile nach den ----):

----- Nach dieser Zeile beginnt die Beispieldatei
Links zum Thema "Filmbelichtung"

Definition (hiernach KEINE Leerzeile)
Sprache {60}
Firma [left]
= http
Titel {40%} 
= http
Beschreibung [justify] {200}

# Hersteller von Diabelichtern

Englisch
Lasergraphics
http://www.lasergraphics.com
Produktliste
http://www.lasergraphics.com/pages/products.htm
Amerikanischer renommierter Hersteller.

Deutsch
Polaroid
http://www.polaroid.de
Polaroid Belichter
http://www.polaroid.de/produkte/belicht.htm
Eine Übersicht über die Filmbelichter von Polaroid.

Englisch
Celco
http://www.celco.com
Celco Belichter
http://www.celco.com/digital_film_recorders.asp
Die futuristischen Celco-Belichter.

Deutsch
CCD
http://www.ccg-germany.com
CCG Belichter
http://www.ccg-germany.com/deutsch/Produkte_seiten/main_productsfilmrec.html
Die klassischen PCR-Belichter.

# Anbieter von Diabelichtern [nohead]

Deutsch
Dr. Jürgen Krüger
http://www.dr-juergen-krueger.de
Produktliste
http://www.dr-juergen-krueger.de/diabelicht.htm
Informative Webseite mit Kaufmöglichkeiten und Gebrauchtangeboten.

Deutsch
ImagePlus Christian Claußner
http://www.imageplus.de
Leider nur Homepage
http://www.imageplus.de
Keine Direktverlinkung möglich.

Deutsch
Mops Computer
http://www.mops-computer.de
Produktübersicht
http://www.mops-computer.de/modelle.htm
Nur CCG Recorder.

usw. usw.